home *** CD-ROM | disk | FTP | other *** search
/ Collection of Internet / Collection of Internet.iso / infosrvr / doc / www_talk.arc / 000252_rik@daneel.rdt.monash.edu.au _Fri Oct 23 11:42:40 1992.msg < prev    next >
Internet Message Format  |  1992-11-30  |  3KB
  1. Return-Path: <rik@daneel.rdt.monash.edu.au>
  2. Received: from dxmint.cern.ch by  nxoc01.cern.ch  (NeXT-1.0 (From Sendmail 5.52)/NeXT-2.0)
  3.     id AA11463; Fri, 23 Oct 92 11:42:40 MET
  4. Received: by dxmint.cern.ch (dxcern) (5.57/3.14)
  5.     id AA24446; Fri, 23 Oct 92 11:54:08 +0100
  6. Received: from daneel.rdt.monash.edu.au by mcsun.EU.net with SMTP
  7.     id AA11276 (5.65b/CWI-2.182); Fri, 23 Oct 1992 11:52:37 +0100
  8. Received: by daneel.rdt.monash.edu.au (5.57/Ultrix3.0-C)
  9.     id AA03886; Fri, 23 Oct 92 20:51:07 +1000
  10. Message-Id: <9210231051.AA03886@daneel.rdt.monash.edu.au>
  11. To: timbl@nxoc01.cern.ch (Tim Berners-Lee)
  12. Cc: www-talk@nxoc01.cern.ch
  13. Subject: Re: Man pages server code, anyone? 
  14. In-Reply-To: Your message of "28 Sep 92 13:40:33 +0100."
  15.              <9209281240.AA04048@ nxoc01.cern.ch > 
  16. Date: Fri, 23 Oct 92 20:51:06 -1000
  17. From: Rik Harris <rik@daneel.rdt.monash.edu.au>
  18. X-Mts: smtp
  19.  
  20. Almost a month ago, Tim wrote:
  21. > I know I heard of someone with a filter for unix man page to HTML,
  22. > but I can't find it.  Does anyone on this list write one?
  23.  
  24. OK, I finally have a reasonably nice-looking man converter.  It does
  25. the following things:
  26.  
  27. * puts section headings in <H2> </H2>'s.
  28. * formats paragraphs with <P>.
  29. * does some special characters.
  30. * hypertext links for references to other manual pages.
  31. * some <HP?> highlighting.
  32.  
  33. Current problems:
  34.  
  35. * it's not lightning fast.
  36. * doesn't handle tbl correctly yet.
  37. * it would be nice to put some things in a <DL> type list.
  38. * many of the special characters missing.
  39. * it does some strange spacing sometimes.
  40.  
  41. The filter is in a number of parts.  The first part is written in perl,
  42. and parses the man page names and gets a list of filenames, which it
  43. pipes to groff.  I have built a special groff filter in perl for the
  44. second part.  This filter takes the groff device-independent intermediate
  45. output, and converts it to HTML.
  46.  
  47. The code's not too bad, but could do with a bit of cleaning-up,
  48. particularly the tbl handling.  You can play with the filter by connecting
  49. to:
  50.  
  51.   http://www.vifp.monash.edu.au:5000/MANPAGE
  52.  
  53. where MANPAGE can just be a name, like 'cat', or it can be a name and
  54. section, like 'cos(3m)'.
  55.  
  56. Please tell me if you notice anything strange, and I will attempt to
  57. fix it.  I'll give the code to people if they really want it, but as I said
  58. before, I hope to clean it up a little before I release it more
  59. generally.  To run the code, you need groff and perl and you need to be
  60. able to install new drivers for groff (I think there's an option for
  61. groff to look in a different directory for drivers).
  62.  
  63. This is part of our local help/documentation system, which will
  64. eventually be complete, changing documentation for our computer
  65. systems.  I essentially wanted to be able to direct people to the man
  66. pages when necessary, and I thought it pointless to have man pages if
  67. you couldn't just click on the "See Also"'s  :-)
  68.  
  69. Have fun, and let me know what you think.
  70.  
  71. rik.
  72. --
  73. Rik Harris - rik.harris@fcit.monash.edu.au         || Systems Programmer
  74. +61 3 571-2895 (AH & ans.mach) +61 3 573-2679 (BH) || and Administrator
  75. Faculty of Computing and Information Technology,   || Vic. Institute of
  76. Caulfield Campus, Monash University, Australia     || Forensic Pathology